Skip to main content

CI Variables

CI Variables are build-time environment variables that are injected into the CI pipeline during execution. Use them to pass configuration values, credentials, or parameters required by your build process.

Accessing CI Variables​

  1. Open the workflow in the Workflow Builder.
  2. Locate the CI Variables option at the bottom-left corner of the interface.
  3. Click to open the CI Variables panel.
CI Variables panel location

Variable List​

The CI Variables panel displays a table of all defined build-time variables:

ColumnDescription
KeyThe variable name (e.g., API_KEY, NODE_ENV).
ValueThe current value assigned to the variable. Secret values are masked unless you have the View secret permission.
TypeThe variable type — Build Time.
ActionEdit or delete the variable.

Managing Variables​

Click the three-dot menu (...) at the top of the CI Variables panel to access management actions:

CI Variables actions menu

ActionDescription
AddCreate a new build-time variable.
ImportImport variables from a Git repository or upload a .env file.
ExportExport all current variables as a downloadable file.

Adding a Variable​

Add CI variable form

  1. Click Add from the actions menu.
  2. Fill in the following fields:
FieldDescription
VariableThe variable name (e.g., API_KEY).
Variable TypeSelect Value.
ValueThe variable value.
SecretToggle to mark the variable as a secret. Secret values are masked in the UI and synced with the connected secret manager (if configured).
  1. Click Create to save, or Create and Add Another to add multiple variables in sequence.

Importing Variables​

Import CI variables options

From Repository​

  1. The integrated source repository (GitHub, GitLab, or Bitbucket) linked to the service is displayed.
  2. Select the branch containing your variable definitions.
  3. Click Proceed to import .env files found in the repository.
Import from repository

Upload .env File​

  1. Upload a .env file containing your variable definitions in KEY=VALUE format.
  2. Click Proceed to import the variables.
Upload .env file

Exporting Variables​

Click Export from the actions menu to download all defined CI variables as a file. This is useful for backup or transferring variables to another workflow.

Secret Manager Integration​

When a secret manager is connected at the project level, CI variables marked as Secret are automatically synced with the external secret manager.

ProviderDescription
AWS Secrets ManagerSecret variables are stored and retrieved from AWS Secrets Manager.
GCP Secret ManagerSecret variables are stored and retrieved from Google Cloud Secret Manager.
info

Secret manager integration is configured from the Project Settings page. It applies to all workflows and environments under that project. See Secret Manager Integration for setup details.